Manager: TextEdit


Carbon supports nearly all TextEdit functions, but TextEdit functionality has been replaced by Multilingual Text Engine (MLTE). Although there is not necessarily a one-to-one correspondence between APIs in these two technologies, you are encouraged to use MLTE in place of TextEdit.

The Carbon version of TextEdit introduces the following changes:

The low memory accessors for TextEdit structures will be replaced as follows:

TEGet/SetScrapLength replaces LMGet/SetTEScrpLength

TEGet/SetScrapHandle replaces LMGet/SetTEScrpHandle

TEGet/SetDoTextHook replaces LMGet/SetTEDoText

TEGet/SetRecalcHook replaces LMGet/SetTERecal



A new accessor has been added for the FindWord hook: TEGet/SetFindWordHook.

TESetWordBreak will be not available in Carbon, and the wordBreak should not be overriden as a way to customize wordBreak behavior. Instead, override the FindWord hook via the TEGet/SetFindWordHook accessors. Previously, the wordBreak hook was only used on Roman-only systems, a distinction that will not exist in Carbon. TERec's wordBreak field will therefore be completely ignored.

Not Recommended  CallCaretHookProc

Not Recommended  CallDrawHookProc

Not Recommended  CallEOLHookProc

Not Recommended  CallHighHookProc

Not Recommended  CallHitTestHookProc

Not Recommended  CallNWidthHookProc

Not Recommended  CallTEClickLoopProc

Not Recommended  CallTEDoTextProc

Not Recommended  CallTEFindWordProc

Not Recommended  CallTERecalcProc

Not Recommended  CallTextWidthHookProc

Supported  CallTSMTEPostUpdateProc

Supported  CallTSMTEPreUpdateProc

Not Recommended  CallWidthHookProc

Unsupported  CallWordBreakProc

If you need to specify a custom word-breaking function, you should do so using the new TEGet/SetFindWordHook accessor functions

Not Recommended  CaretHookProcPtr

Not Recommended  DisposeCaretHookUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  DisposeDrawHookUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  DisposeEOLHookUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  DisposeHighHookUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  DisposeHitTestHookUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  DisposeNWidthHookUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  DisposeTEClickLoopUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  DisposeTEDoTextUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  DisposeTEFindWordUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  DisposeTERecalcUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  DisposeTextWidthHookUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  DisposeTSMTEPostUpdateUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  DisposeTSMTEPreUpdateUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  DisposeWidthHookUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  DisposeWordBreakUPP

If you need to specify a custom word-breaking function, you should do so using the new TEGet/SetFindWordHook accessor functions

Not Recommended  DrawHookProcPtr

Not Recommended  EOLHookProcPtr

Supported  GetTSMDialogDocumentID

Supported  GetTSMDialogPtr

Supported  GetTSMDialogTextEditHandle

Supported  GetTSMTEDialogDocumentID

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  GetTSMTEDialogTSMTERecHandle

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  HighHookProcPtr

Not Recommended  HitTestHookProcPtr

Not Recommended  InvokeCaretHookUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  InvokeDrawHookUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  InvokeEOLHookUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  InvokeHighHookUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  InvokeHitTestHookUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  InvokeNWidthHookUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  InvokeTEClickLoopUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  InvokeTEDoTextUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  InvokeTEFindWordUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  InvokeTERecalcUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  InvokeTextWidthHookUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  InvokeTSMTEPostUpdateUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  InvokeTSMTEPreUpdateUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  InvokeWidthHookUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Unsupported  InvokeWordBreakUPP

If you need to specify a custom word-breaking function, you should do so using the new TEGet/SetFindWordHook accessor functions

Supported  IsTSMTEDialog

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  LMGetWordRedraw

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  LMSetWordRedraw

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  NewCaretHookUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  NewDrawHookUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  NewEOLHookUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  NewHighHookUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  NewHitTestHookUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  NewNWidthHookUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  NewTEClickLoopUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  NewTEDoTextUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  NewTEFindWordUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  NewTERecalcUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  NewTextWidthHookUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  NewTSMTEPostUpdateUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  NewTSMTEPreUpdateUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  NewWidthHookUPP

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Unsupported  NewWordBreakUPP

If you need to specify a custom word-breaking function, you should do so using the new TEGet/SetFindWordHook accessor functions

Not Recommended  NWidthHookProcPtr

Supported  SetTSMDialogDocumentID

Supported  SetTSMDialogTextEditHandle

Supported  SetTSMTEDialogDocumentID

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  SetTSMTEDialogTSMTERecHandle

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TEActivate

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TEAutoView

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TECalText

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TEClick

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Unsupported  teclick

Use TEClick instead. Not available in Carbon.

Not Recommended  TEClickLoopProcPtr

Not Recommended  TEContinuousStyle

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TECopy

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TECustomHook

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TECut

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TEDeactivate

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TEDelete

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TEDispose

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TEDoTextProcPtr

Not Recommended  TEFeatureFlag

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TEFindWordProcPtr

Not Recommended  TEFromScrap

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  TEGetDoTextHook

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  TEGetFindWordHook

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TEGetHeight

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TEGetHiliteRgn

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TEGetOffset

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TEGetPoint

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  TEGetRecalcHook

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  TEGetScrapHandle

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TEGetScrapLength

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TEGetStyle

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TEGetStyleHandle

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TEGetStyleScrapHandle

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TEGetText

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TEIdle

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Unsupported  TEInit

There is no need to initialize TextEdit because the shared library is loaded as needed. Not available in Carbon.

Not Recommended  TEInsert

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TEKey

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TENew

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TENumStyles

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TEPaste

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TEPinScroll

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TERecalcProcPtr

Not Recommended  TEReplaceStyle

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TEScrapHandle

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TEScroll

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TESelView

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TESetAlignment

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TESetClickLoop

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  TESetDoTextHook

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  TESetFindWordHook

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  TESetRecalcHook

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Supported  TESetScrapHandle

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TESetScrapLength

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TESetSelect

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TESetStyle

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TESetStyleHandle

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TESetText

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Unsupported  TESetWordBreak

You should override the FindWord hook using the TESetFindWordHook accessor function instead of calling TESetWordBreak. Not available in Carbon.

Not Recommended  TEStyleInsert

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TEStyleNew

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TEStylePaste

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TETextBox

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TEToScrap

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TEUpdate

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TEUseStyleScrap

Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

Not Recommended  TextWidthHookProcPtr

Not Recommended  TSMTEPostUpdateProcPtr

Not Recommended  TSMTEPreUpdateProcPtr

Not Recommended  WidthHookProcPtr

Unsupported  WordBreakProcPtr

If you need to specify a custom word-breaking function, you should do so using the new TEGet/SetFindWordHook accessor functions

[Table of Contents] [Manager Index] [Function Index]

Generated on: 8/1/2000. Copyright © 1999, 2000 Apple Computer, Inc. All rights reserved.